home *** CD-ROM | disk | FTP | other *** search
/ The Apple Sales & Marketi…urce Library 1999 August / Resource Library August 99.toast / mac / AppleShare IP 6.2 (NFR) / AppleShare IP 6.2 Install / AppleShare Client / International Folder / British / DHX UAM Read Me < prev   
Text File  |  1999-04-16  |  3KB  |  69 lines

  1. DHX User Authentication Module 1.0 Read Me
  2.  
  3.  
  4. CONTENTS
  5.  
  6. Introduction
  7. Requirements for Running the DHX UAM 1.0
  8. Installing the DHX UAM 1.0
  9. Using the DHX UAM 1.0
  10. Algorithms used
  11. Known Incompatibilities and Limitations
  12.  
  13.  
  14. Introduction
  15. The DHX (Diffie-Hellman Exchange) UAM provides a relativly secure way to transport cleartext passwords of up to 64 characters to the server for further processing.
  16.  
  17. Requirements for Running the DHX UAM 1.0 
  18.  
  19. •  AppleShare Client:  3.8.1 or later
  20.  
  21.  
  22. Installing the DHX UAM 1.0 
  23.  
  24. The UAM should be placed in a folder titled "AppleShare Folder" within the Extensions folder in the current System Folder. No reboot is needed, though you must close the Chooser & Network Browser and re-open them before the new UAM will be noticed.
  25.  
  26. Using the DHX UAM 1.0 
  27. If the server you are connecting to supports the DHX UAM, the AppleShare Client will display a  dialogue allowing you to choose "Encrypted Password" as a login mechanism. Select this UAM and fill in your password and username just as you would for the standard AppleShare login dialogue.
  28.  
  29. Algorithms Used
  30.  
  31. password is padded with nulls to 64 bytes
  32. username is a pstring, padded to even byte length (odd number of chars)
  33. ServerSig is obtained from the AFPSrvrInfo reply from the server.
  34.  
  35. first message from client to server:
  36. | login (2 bytes)  | AFP Vers | UAMName "DHCAST128" | Username (padded) | Ma (16 bytes) |
  37.  
  38. reply (server to client)
  39. | ID (2 bytes) | Mb (16 bytes) | (16 byte nonce, ServerSig)K |
  40.  
  41. login continue (client to server)
  42. | logincontinue (2 bytes) | ID (2 bytes) | (16 byte nonce + 1, password)K |
  43.  
  44. reply (server to client)
  45. pass / fail
  46.  
  47. (data)K = Encrypt data using CAST 128 CBC with key = K
  48.  
  49. The Key is generated with a Diffie-Hellman key exchange as follows:
  50. Ma - first message = g^Ra mod p  (sent by the Client to the Server)
  51. Mb - second message = g^Rb mod p (sent by the Server to the Cleint)
  52. K - Key = Mb^Ra mod p = Ma^Rb mod p
  53.  
  54. We are using CAST 128, (the implementation from SSLeay) in CBC mode with the IV in the second message being the bytestring "CJalbert" and the IV in the third message being the bytestring "LWallace".
  55.  
  56. Known Incompatibilities and Limitations
  57.  
  58. • There seems to be a problem between Norton Antivirus and the DHX UAM. The client Macintosh will crash with an illegal instruction when the user types into the username or password fields. The workaround is to turn off Norton Antivirus.
  59.  
  60.  
  61.  
  62. © 1999 Apple Computer, Inc. All rights reserved. Apple, the Apple logo, AppleShare, AppleTalk, HyperCard, LocalTalk, Mac, Macintosh, MacTCP, and PowerBook are trademarks of Apple Computer, Inc., registered in the United States and other countries. PowerPC is a trademark of International Business Machines Corporation, used under licence therefrom.
  63. The CAST implementation was written by   Eric Young (eay@cryptsoft.com) for SSLeay.
  64. The bignum routines were written by Wei Dai for cryptlib.
  65.  
  66. Created March 16, 1999
  67. Modified March 22, 1999.
  68.